home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.5 / groff_out.5 < prev    next >
Text File  |  1995-07-25  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4.      GGGGRRRROOOOFFFFFFFF____OOOOUUUUTTTT((((5555))))   GGGGrrrrooooffffffff VVVVeeeerrrrssssiiiioooonnnn 1111....00009999 ((((00004444 MMMMaaaarrrrcccchhhh 1111999999994444))))    GGGGRRRROOOOFFFFFFFF____OOOOUUUUTTTT((((5555))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           groff_out - groff intermediate output format
  10.  
  11.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.           This manual page describes the format output by GNU troff.
  13.           The output format used by GNU troff is very similar to that
  14.           used by Unix device-independent troff. Only the differences
  15.           are documented here.
  16.  
  17.           The argument to the ssss command is in scaled points (units of
  18.           _p_o_i_n_t_s/n, where _n is the argument to the ssssiiiizzzzeeeessssccccaaaalllleeee command
  19.           in the DESC file.) The argument to the xxxx HHHHeeeeiiiigggghhhhtttt command is
  20.           also in scaled points.
  21.  
  22.           The first three output commands are guaranteed to be:
  23.  
  24.                xxxx TTTT _d_e_v_i_c_e
  25.                xxxx rrrreeeessss _n _h _v
  26.                xxxx iiiinnnniiiitttt
  27.  
  28.           If the ttttccccoooommmmmmmmaaaannnndddd line is present in the DESC file, troff will
  29.           use the following two commands
  30.  
  31.           tttt_x_x_x _x_x_x is any sequence of characters terminated by a space
  32.                or a newline; the first character should be printed at
  33.                the current position, the the current horizontal
  34.                position should be increased by the width of the first
  35.                character, and so on for each character.  The width of
  36.                the character is that given in the font file,
  37.                appropriately scaled for the current point size, and
  38.                rounded so that it is a multiple of the horizontal
  39.                resolution.  Special characters cannot be printed using
  40.                this command.
  41.  
  42.           uuuu_n _x_x_x
  43.                This is same as the tttt command except that after
  44.                printing each character, the current horizontal
  45.                position is increased by the sum of the width of that
  46.                character and _n.
  47.  
  48.           Note that single characters can have the eighth bit set, as
  49.           can the names of fonts and special characters.
  50.  
  51.           The names of characters and fonts an be of arbitrary length;
  52.           drivers should not assume that they will be only two
  53.           characters long.
  54.  
  55.           When a character is to be printed, that character will
  56.           always be in the current font.  Unlike device-independent
  57.           troff, it is not necessary for drivers to search special
  58.           fonts to find a character.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 7/8/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      GGGGRRRROOOOFFFFFFFF____OOOOUUUUTTTT((((5555))))   GGGGrrrrooooffffffff VVVVeeeerrrrssssiiiioooonnnn 1111....00009999 ((((00004444 MMMMaaaarrrrcccchhhh 1111999999994444))))    GGGGRRRROOOOFFFFFFFF____OOOOUUUUTTTT((((5555))))
  71.  
  72.  
  73.  
  74.           The DDDD drawing command has been extended.  These extensions
  75.           will not be used by GNU pic if the ----nnnn option is given.
  76.  
  77.           DDDDffff _n\n
  78.                Set the shade of gray to be used for filling solid
  79.                objects to _n; _n must be an integer between 0 and 1000,
  80.                where 0 corresponds solid white and 1000 to solid
  81.                black, and values in between correspond to intermediate
  82.                shades of gray.  This applies only to solid circles,
  83.                solid ellipses and solid polygons.  By default, a level
  84.                of 1000 will be used.  Whatever color a solid object
  85.                has, it should completely obscure everything beneath
  86.                it.  A value greater than 1000 or less than 0 can also
  87.                be used: this means fill with the shade of gray that is
  88.                currently being used for lines and text.  Normally this
  89.                will be black, but some drivers may provide a way of
  90.                changing this.
  91.  
  92.           DDDDCCCC _d\n
  93.                Draw a solid circle with a diameter of _d with the
  94.                leftmost point at the current position.
  95.  
  96.           DDDDEEEE _d_x _d_y\n
  97.                Draw a solid ellipse with a horizontal diameter of _d_x
  98.                and a vertical diameter of _d_y with the leftmost point
  99.                at the current position.  delim $$
  100.  
  101.      $dy sub n$\n
  102.           DDDDpppp $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx sub n$
  103.                Draw a polygon with, for $i = 1 ,..., n+1$, the _i-th
  104.                vertex at the current position $+ sum from j=1 to i-1 (
  105.                dx sub j , dy sub j )$.  At the moment, GNU pic only
  106.                uses this command to generate triangles and rectangles.
  107.  
  108.      $dy sub n$\n
  109.           DDDDPPPP $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ $dx sub n$
  110.                Like DDDDpppp but draw a solid rather than outlined polygon.
  111.  
  112.           DDDDtttt _n\n
  113.                Set the current line thickness to _n machine units.
  114.                Traditionally Unix troff drivers use a line thickness
  115.                proportional to the current point size; drivers should
  116.                continue to do this if no DDDDtttt command has been given, or
  117.                if a DDDDtttt command has been given with a negative value of
  118.                _n.  A zero value of _n selects the smallest available
  119.                line thickness.
  120.  
  121.           A difficulty arises in how the current position should be
  122.           changed after the execution of these commands.  This is not
  123.           of great importance since the code generated by GNU pic does
  124.           not depend on this.  Given a drawing command of the form
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 7/8/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      GGGGRRRROOOOFFFFFFFF____OOOOUUUUTTTT((((5555))))   GGGGrrrrooooffffffff VVVVeeeerrrrssssiiiioooonnnn 1111....00009999 ((((00004444 MMMMaaaarrrrcccchhhh 1111999999994444))))    GGGGRRRROOOOFFFFFFFF____OOOOUUUUTTTT((((5555))))
  137.  
  138.  
  139.  
  140.                \\\\DDDD''''_c $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ $x
  141.                sub n$ $y sub n$'
  142.  
  143.           where _c is not one of cccc, eeee, llll, aaaa or ~~~~, Unix troff will treat
  144.           each of the $x sub i$ as a horizontal quantity, and each of
  145.           the $y sub i$ as a vertical quantity and will assume that
  146.           the width of the drawn object is $sum from i=1 to n x sub
  147.           i$, and that the height is $sum from i=1 to n y sub i$.
  148.           (The assumption about the height can be seen by examining
  149.           the sssstttt and ssssbbbb registers after using such a DDDD command in a \w
  150.           escape sequence.) This rule also holds for all the original
  151.           drawing commands with the exception of DDDDeeee.  For the sake of
  152.           compatibility GNU troff also follows this rule, even though
  153.           it produces an ugly result in the case of the DDDDffff, DDDDtttt, and,
  154.           to a lesser extent, DDDDEEEE commands.  Thus after executing a DDDD
  155.           command of the form
  156.  
  157.                DDDD_c $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ $x sub
  158.                n$ $y sub n$\n
  159.  
  160.           the current position should be increased by $( sum from i=1
  161.           to n x sub i , sum from i=1 to n y sub i )$.
  162.  
  163.           There is a continuation convention which permits the
  164.           argument to the xxxx XXXX command to contain newlines: when
  165.           outputting the argument to the xxxx XXXX command, GNU troff will
  166.           follow each newline in the argument with a ++++ character (as
  167.           usual, it will terminate the entire argument with a
  168.           newline); thus if the line after the line containing the xxxx XXXX
  169.           command starts with ++++, then the newline ending the line
  170.           containing the xxxx XXXX command should be treated as part of the
  171.           argument to the xxxx XXXX command, the ++++ should be ignored, and
  172.           the part of the line following the ++++ should be treated like
  173.           the part of the line following the xxxx XXXX command.
  174.  
  175.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  176.           ggggrrrrooooffffffff____ffffoooonnnntttt(5)
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 7/8/94)
  196.  
  197.  
  198.  
  199.